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In another HT8* the design principles used to implement the new 
library maintenance tool's were developed* and the strategy for 
centralizing the library organization information ana search 
procedures was outlined. 

This HTB describes the command interfaces for two new tools* 
Jibrary_map (Im) and I ibrary_pri nt (Ipr). Iibrary_map replaces 
the us l__short_f ormat and ms i_gl oba I _f ormat commands by providing 
detailed status information for all entries in the Hultics System 
Libraries. I ibrary_pr i nt performs a new library maintenance 
function* that of gathering together a group of printable library 
entries (like info segments* peruse text segments* bind lists* 
source segments* etc) into an MSF for print ing of f I ine. 

The HTB also describes the I ibrar y_descriptor command* which can 
be used to set the name of the default library descriptor and to 
return information about the contents of a library descriptor. 
And finally* a description of the mu I tics_l ibrari es_ library 
descriptor is included. 

These commands and the library descriptor will be includes in a 
design review of the new library tools* to be held in the near 
future. Note that the command which replaces msl_info has not 
been completely oesigned yet* ana will be described by a 
subsa quent HTB. 
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tiaia: library_map, Im 

The library_map command selects entries from a library, and 
writes the status of these entries into a file suitable for 
dprinting. The entries in the file are alphabetized by primary 
name. 

A full range of status information can be included in the 
output by using the various output arguments. Besides the 
information returnee by the status command* the status can 
include object segment attributes reported by obJect__inf o__ and 
library-dependent information. 

The command uses a library descriptor data base and search 
program to define the structure, contents, and naming conventions 
of the library. Refer to the writeup for the 

I i brar y_oescr iptor_compi ler for more information about library 
descr iptors. 

When no output arguments are specified, the choice of status 
information is controlled by the library search program for the 
particular library being mappea. For the Multics Offline 
Libraries (Hardcore, Salvager, BOS, and 355), the information 
includes* the names on each library entry; it entry type? its 
cate of modification ana path name? and (for Hardcore and 
Salvager Libraries) the id of the system in which the entry was 
last installed. For other Multics Libraries, the information 
incljoes* the names on each library entry? its entry type? its 
dates of modification and dumping? its path name and the path 
name of a I ink * s tar get ? ana its current length, oit count, and 
ring brackets. 

I ibrary_map -search_namei- • • • -search_nameo- 
-ct I _argl~ • • • -ct I _ar gQ- -out put 1- ... -out put q- 

The search names, control arguments, and output arguments 
described below appear in the command in any order. 



I I 
i I ibrary_map I 
I 1 
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1) sa arch_namei 

is an entry name which identifies the library 
entries to be output. The Muitics star convention 
may be used to identify a group of entries. If no 

search names are specified, then the default 

search names specified in the library descriptor 
are used. 



2) ctl_argi may be any of the following control arguments. 

-search_name search ha"!? 

-snm s_e_aj:cJi_Q£iffl_t 

is an entry name which identifies the library 
entries to be output. The Muitics star convention 
may be used to identify a group of entries. This 
control argument must be used when search na rcg 
begins with a minus (-) to distinguish the 
search nafpe from a control argument. The 
- search__name control argument may be used several 
times in the same command to specify several 
different search names. 



- I i brar y J_jJ_ 

-lb J.ib_ is a name which identifies the particular 

I ibrary or group of I ibraries which are to be 
searched when the library descriptor describes 
more than one library. The Muitics star 
convention may be used to identify a group of 
libraries. The list of acceptable library names 
is defined by the library descriptor. More than 
one -library control argument may be specified to 
identify several groups of libraries. If the 
-library control argument is not specified, then 
the aefault library names specified in the library 
descriptor are used. 



-output_file file 

"■of LH.S. ,f JJLfi is the path name of the output file in which 
the library map is to be generated. It may be a 
relative or absolute path name. If it does not 
end in a suffix of .map, then one is assumed. If 
the -output_.fi le control argjment is not 
specified, then the map is generated in the 
I ibrary. map file created in the working directory. 
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-header head! ng 
-he bfea.dj.aa 

tiS^aiaa is a character string which is placea on 
the header page of the output file to identify the 
contents of the file* If the string contains 
Planks* then it must Pe enclosed in quotes. Only 
the first 12Q characters of the string will be 
used. If the -heacer control argument is not 
specified, then a default heading is placed on the 
heading page. (See No tes below.) 

-footer foot ing 

-to laaiiaa 

f oo t i n 9 is a character string which is placed in 
the footing line of each output page to identify 
the library being mapped. If the string contains 
blanks* then it must be enclosed in quotes. Only 
the first <+5 characters of the string are used. 
If the -footer control argument is not specified, 
then a default footing line is usea. (See Notes 
bel ow. ) 

-parent, -par 

specifies that status information should be output 
for the parent of each I iorary entry. For 
example, information about an archive will be 
output when one of its components matches a search 
name. Normally, the output includes status for 
only those library entries which match a search 
name • 

-components 

-cmp specifies that status information should be output 

for all components of library archives which are 
identified by a search name. Normally, the output 
includes status for only those library entries 
which match a search name. 



I 1 

I I ibrary_map I 
I I 
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-retain specifies that library entries which await 

deletion from the library (as determined by the 
library search program) should be output* 
Normally* such entries are excluded. 

- 1 i brar y_descri pt or re f pane, 
- 1 d s ce_JLQ2nie. 

r ef narge is the reference name of the library 
descriptor which describes the libraries to be 
searched. The descriptor identified by the 
r ef pame will be found by using the search rules, 
which are documented in MPM Section 3.2. If the 

- I i br ar y__descr iptor control argument is not 
specified, then the default library descriptor is 
usee. (See Nptes below.) 

-chase requests that any links which exist between a 

library link and its eventual target be omitted 
from the output. Normally, these intermediate 
links are induced. 

-check_archi ve, -ckac 

specifies that each library segment and archive 
component is to be checked to see if it is an 
archive segment, or an archived archive. If the 

- check__ar ch i ve control argument is not specified, 
checking for archives will be performed at the 
option of the library search program. 

-check_charac ter , -ckch 

specifies that each library entry is to be checked 
to see if its contents is unprintable (i.e., 
contains non-ASCII characters). In addition, 
unprintable segments are checked to determine if 
they are peruse_text object segments. If the 
- check_character control argument is not 
specified, character checking will be performed at 
the option of the library search program. 

-check_ob J ec t , -ckob 

specifies that each library segment and archive 

component is to be checked to see if it is an 

object segment. If the -check_ob J ec t control 

argument is not specified, object checking will be 

performed at the option of the library search 
program. 
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-check* -cK 

specifies that all there types of checking 
(archive, character, and object) are to be 
per formed • 

3) output! may be any of the following output arguments. 

These arguments specify which status information 
is to be returnees for each library entry which 
appears in the map. If no output arguments are 
specified, then default information is output for 
each library entry, under control of the library 
search program. 



-default, -dft 

requests that the default information for each 
library entry be output, in addition £a output 
requested by any other output arguments. 

-all, -a requests that all available status information be 
output. 

-name, -nm requests that all of the names on each library 
entry be output. 

-first, -ft requests that the first name on each library entry 
be output. 

-match requests that the names on each library entry 

which match any of the search names given in the 
I ibrary_map command be output. 

-type, -tp requests that the type of each library entry 
(link, segment, airectory, archive, archive 
component, multi-segment file, or msf component) 
be output. 

-oarent_path, -pp 

requests that the path name of the parent of each 
library entry be output. 



-link, -Ik requests that the path name of the target of a 
library link be output. 
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-date, -dt requests that the date modified, date used, date 
entry moaifiea, ana aate dumpea for each library 
entry be output. For an archive component, the 
aate entry modified corresponds to the aate 
component updated. 



-date_modi f ied, -dtm 

requests that the aate on which each library entry 
was last modified be output. 

- date__used, -dtu 

requests that the date on which each library entry 
was last used be output. 

~da te_entry_modif lea, -dtem 

requests that the date on which the entry for a 
library link, segment, directory, archive, or 
multi-segment file was last moaified, or the aate 
on which a library archive component was last 
updated into its archive, be output. 

- □ a te_aumpea , -dta 

requests that the date on which a library entry 
was last dumped onto a backup tape be output. 

- I ength , - 1 n 

requests that the current length, recoras used, 
and bit count or ms f indicator of each library 
entry be output. The records used are included 
only when different from the current length. 

-curr ent_l eng th, -cln 

requests that the current iength of each library 
entry be output. 



•recoras_useo» -ru 

requests that the number of records occupied by 
each library entry be output. For a mu I ti- segment 
file, the value includes only those records used 
by the ms f directory. Those occupied by the ms f 
components are included in the map entry for each 
component. If both the current length and recoros 
used have been requested, then the records used 
will be omitted from the output if equal to the 
current length. 
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-bit_count* -be 

requests that the bit count of each library 
segment* archive* archive component* and msf 
component be output* along with the msf indicator 
of each library multi-segment file* 



access* -acs 

requests that the user's 

J ibrary entry* and each 

brackets be output. 



access mode to each 
library entry's ring 



node* -md requests that the user's access mode to each 
library entry be output. 



~ ing_bracket s* -rb 
r eques ts 
entry be 



that the 
output • 



ring brackets of each library 



-contents* -ct 



c t 

requests that the contents of each library entry 
be checked to determine whether the entry is an 
archive* an object entry (i.e.* an object segment 
or archive component)* a peruse text object entry* 

" - *--• For each 



r arcnive component* a peruse rexT odj ecT emry 
r another type of unprintable entry. For eac 
bject entry* the following information is output 
ate compiled or bound? compiler or binde 



or 
o 

date compiled or bound* compiler or binder 
version number* compiler options* and object 
entry attributes. The compiler version number and 
printable character length of each peruse text 
object entry is output. An indication is output 
for each unprintable entry. (See tiaias below.) 

da te_compi I ec* -dtc 

requests that the date compiled be output for each 
library (bound or unbound) object entry. (See 
bialfeS. below.) 



compi I er__version -cv 

requests that name ana 
output for the compiler 
( See Notes below.) 



version 
of each 



information be 
object entry. 



compi ler__opt ions* -co 

requests that the options used when compiling each 
object entry be output. (See Not e^ below.) 
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-oo ]ect_inf o, ~oi 

requests that the attributes of each object entry 
be output. Attributes include? bound object 
indicator? old object format indicator? 

n on-s tanaaro object format indicator? ana the 
octal value of any call limiter. (See Notes 
be I ow. ) 

-character, - ch 



requests that an indication be output for each 
ntry whose contents is unprintable (i.e.* 
non-ASCII characters) #c«„ 



I iorary e 
contains 
be I ow • ) 



(See tiolfis. 



oeruse_text, -pt 

requests that the compiler version number and 
printable character length be output for each 
peruse text object entry. (See Nqf g§ below.) 



- devi ce_id, 



- di a 

requests that 
I ibrary entry 



the type 
is stored 



of 

be 



aevice 
output . 



on 



which the 



copy_switch, -cs 

requests 



that the copy 
I ibrary entry be output. 



switch setting for the 



-offset requests that the offset (from the beginning of 

its containing segment) of the contents of an 

archive component be output. The offset is an 
octal word count. 



- jn ique_id, 



- ui c 

requests that the unique identifier of the library 
entry be output in octal. 



-error, -er 



requests that any error which occurred while 
obtaining status be indicated by the appropriate 
error message* The message appears in the map 
entry for the parent of the library entry in which 
the error occurred. 
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- 1 eve I » - J v 

requests that a levei number be output for each 
library entry. The level number indicates the 
relationship between a library entry ana its 
components. For example, the map entry for an 
archive might appear in the map at level i» and 
the archive's components might appear at level 2. 
Normally, the level is indicated only by relative 
indentation of entry names. 

-new_line, -n I 

requests that a line be skipped before writing the 
status of each level l entry in the map. This 
line makes it easier to identify level 1 entries. 
Normally, no lines are skipped between entries. 

If the output file already exists, it is truncated and 
rewritten. Thus, if several library_map commands are executeo in 
the same working directory (by the same process, or by different 
processes) without including an -output_file control argument, 
then the output of all but the last command is overwritten. In 
such cases, the -out put_f i I e control argument should be specified 
to prevent the output of the last command from overwriting the 
outpjf of prececing commands. 

If the -header k&aalgg control argument is specified, then 
the head ipg character string is centered on the header page of 
the output file beneath the linesi 

Map of the aa Entries 

of the 

The ufeadina character string should be worded with this in mind. 
For exampleJ 

Map of the 35 Entries 
of the 

Standard Service System Bind Listing Library 
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If 10 -header control argument is specified* then a default 
heading line is constructed by concatenating the library names, 
as shown below: 

Hap of the 35u Entries 
of the 
Li brar ies 

s tana ard_ser vice, list* unbundl ed. list, 
tools, list, author_ma int ained, I ist , networK.list 

If the -footer f ppf ing control argument is specified, then 
the tflflt aqo, line appears at the lower left corner of each output 
page (except the heacer page), along with the name(s) of the 
level i entries appearing on that page, and the page number. If 
the -footer control argument is omitted, then the library names 
are concatenated together as with the default heading line, and 
usea as the default footing line- 
In order for some output arguments to take effect, 
information in addition to simple status must be available. 
Therefore, some output arguments automatically invoke certain of 
the control arguments. For example, the -contents output 
argument requires that archive, character, and object checking be 
performed, and therefore invokes the -check control argument. 
Similarly, -date_compi I eo, -compi 1 er_version, -compi I er_opt i ons , 
and - ob ) ect__in f o output options invoke the -check_ob J ect control 
argument; and the -character and -peruse_text output arguments 
invoKe the -check_char act er control argument. The -all output 
argument invokes the -parent, -default, and -check control 
arguments, as well as all of the output arguments. 

The default library name(s) and search name(s) used for the 
library_map command are defined in the library descriptor for the 
libraries being mapped. The I i brary_descr i pt or command can be 
used to print these default values. In particular, the default 
values for the default library descriptor can be printed by 
typing the command: 

Ids default I ibrary_map 

Refer to the writeup on the I ibrar y_descriptor command for more 
de tai 1 s. 
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When no - 1 1 brary.descr iptor control argument is given in the 
command, the default library Descriptor is used. The name of the 
default library descriptor can be set and printed with the 
I i brar y-.ae.scr iptor command. The Initial default library 
descriptor describes the Mul tics System Libraries. 

The command 

I ibrary_roap -lb info** -lb peruse_text . inf o ♦♦•info ♦♦•pt 
•of ■ documentation 

creates the documentation* map file in the working directory* 
which contains a nap of the entries in the inf o. ♦ and 
peruse_text •♦ libraries which match the search names ♦♦.info or 
♦♦•pt • The command 

library_map -lb online.^ ♦♦ -of online -dtd -dft 

creates the online. map file which contains a map of all of the 
entries in the online. ♦libraries. Each map entry includes the 
date dumped* as well as whatever default information was 
specif ieo by the library search program. The command 

I ibrary_map 

creates a map in the library.map file of the working directory 
which contains status for those entries in the default library 
(or I ibraries) which match the def aul t search name(s) • These 
defaul t values are specified by the default library descriptor 
data base. 
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fclaifiJ I i brar y_pri nt , I pr 

The I ibrar y_print commanc selects printable entries from a 
library, and writes the contents of these entries into a file 
suitable for sprinting. Printable library entries are those 
whicn contain only ASCII characters. The ASCII portion of peruse 
text object segments is also printable. Thus printable entries 
can include source segments, listings, bind files, info segments, 
peruse text object segments, exec_.com control segments, printable 
mu I ti -segment files, etc. 

The entries in the print file are alphabetized by primary 
name. Each entry is preceded by a header which lists the status 
of the entry. An index of all entry names appears at the end of 
the f i le. 

The command uses a library oescriptor data base and search 
program to define the structure, contents, and naming conventions 
of the library. Refer to the writeup for the 

I ibrary_descr iptor_compi I er for more information about library 
descriptors. 



When no output arguments are specified, the status 
information which is included in the header of each entry is 
controlled by the library search program for the particular 
library being printed. For the Multics System Libraries, the 
information includesi the names on the library entry? its entry 
type; its date of modification; its path name; and (for 
Hardcore and Salvager Libraries) the id of the system in which 
the entry was last installed. 



1 ibrary_print -search_namei- • • • -search_nameQ- 
-ct I _argl-. • . -ct l_argQ- -outputi- • • . -out put q- 

The search names, control arguments, and output arguments 
described below appear in the command in any order. 



1) search_namei 

is an entry name which identifies the library 
entries to be output. The Multics star convention 
may be used to identify a group of entries. If no 
search names are specified, then the default 
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search names specified in the library descriptor 
are used, 

2) ctl_argi may be any of the following control arguments. 

-search_name ^eapqh name 

-snm s.e.a.r_££L-Qajie. 

is an entry name which identifies the library 
entries to be output. The Multics star convention 
may be used to identify a group of entries. This 
control argument must be used when sear,Gh,,.„Qaroe„ 
begins with a minus (-) to distinguish the 
Search naiUft from a control argument. The 
-search_name control argument may be used several 
times in the same commano to specify several 
different search names. 

- I i brary lib 

-lb lib life is a name which identifies the particular 

library or group of libraries which are to be 
searched when the library descriptor describes 
more than one library. The Multics star 
convention may be used to identify a group of 
libraries. The list of acceptable library names 
is defined by the library descriptor. More than 
one -library control argument may be specif ieo to 
identify several groups of libraries. If the 
-library control argument is not specified* then 
the default library names specified in the library 
descriptor are used. 

-output_file f i I e 

-of Ills, filg is the path name of the output file in which 
the library print out is to be generateo. It may 
be a relative or absolute path name. If it does 
not end in a suffix of .print* then one is 
assumed. If the -output_.fi le control argument is 
not specified, then the print out is generated in 
the I ibrary .pr in t file created in the working 
a irec t ory • 
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-header heacj j. ng 

-he baailiQai 

ftfefiCtiaa is a character string which is placee on 
the header page of the output file to identify the 
contents of the file* If the string contains 
blanks* then it must be enclosed in quotes. Only 
the first 120 characters of the string will be 
usee If the -heaoer control argument is not 
specified, then a default heading is placed on the 
heading page* (See Malfis below.) 

-footer lo.oJ.iog. 

_f PQt, lug is a character string which is placed in 
the footing line of each output page to identify 
the library being printed. If the string contains 
blanks, then it must be enclosed in quotes. Only 
the first characters of the string are used. 

If the -footer control argument is not specified, 
then a default footing line is usea. (See ty ote s 
bel ow. ) 

-parent, -par 

specifies that the contents of the parent of each 
library entry should be output, rather than the 
library entry itself. For example, the contents 
of an archive will be output when one of its 
components matches a search name. Normally, only 
those library entries which match a search name 
are output. 

-components 

-cmp specifies that the contents of each component of a 

I ibrary archive which matches a search name is to 
be output individually. Normally, only matching 
components of the archive are output (or if no 
components match, the entire archive is output). 
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-retain specifies that library entries which await 

aeletion from the library (as determined by the 
library search program) should be output* 
Normally* such entries are excluded. 

-I i brar y_descri ptor re f name 
-Ids Cfclaaiae. 

Cfiinamfe is the reference name of the library 
descriptor which describes the libraries to be 
searched. The descriptor identified by the 
r slPSrae will be found by using the search rules* 
which are documented in MPM Section 3.2. If the 
- I ibrary_descriptor control argument is not 
specified* then the default library descriptor is 
used. (See fcio_i£.s. below.) 

-chase requests that any links which exist between a 

library link and its eventual target be omitted 
from the status information in the header. 
Normally, these intermediate links are included. 

- check_archi ve» -ckac 

specifies that each library segment and archive 

component is to be checked to see if it is an 

archive segment* or an archived archive. If the 
- check_arch ive control argument is not specified* 

checking for archives will be performed at the 
option of the library search program. 

-check_charac ter * -ckch 

specifies that each library entry is to be checked 
to see if its contents is unprintable (i.e., 
contains non-ASCII characters). In addition, 
unprintable segments are checked to determine if 
they are peruse_text object segments. If the 
-check_charac ter control argument is not 
specified* character checking will be performed at 
the option of the library search program. 

-check_obJ ect , -ckob 

specifies that each library segment ano archive 
component is to be checked to see if it is an 
object segment. If the -check_obJ ect control 
argument is not specified* object checking will be 
performed at the option of the library search 
program. 
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-check, -ck 



specifies that aJ I there types of checking 
(archive* character, and object) are to be 
per formed • 



3) ojtputi 



may be any of the following output arguments. 
These arguments specify which status information 
is to be returnee in the header of each library 
entry which appears in the print out. If no 
output arguments are specified, then default 
information is output for each library entry, 
under control of the library searcn program. 



-default, -dft 



all, -a 



requests that the default information for each 
library entry be output, 1q ajidJXLaQ la output 
requested by any other output arguments- 
requests that all available status information be 
output • 



-name, -nm requests that all of the names on 
entry be output. 



each library 



first, -ft requests that the first name on each library entry 
be output. 



- -natch 



-type, -to 



requests that the names on each library entry 
which match any of the search names given in the 
I ibrary__print command be output. 

requests that the type of each library entry 
(link, segment, directory, archive, archive 
component, mul ti -segment file, or msf component) 
be output. 



parent_path, - pp 

requests that the path name of the parent of each 
library entry be output. 

link, -Ik requests that the path name of the target of a 
library link be output. 

date, -dt requests that the date modified, date used, date 
entry modified, and date dumped for each library 
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entry be output* For an archive component, the 
date entry modified corresponds to the date 
component updated. 

date_modi f i eci -dtm 

requests that the date on which each library entry 
was last modified be output. 

date^usea, -atu 

requests that the date on which each library entry 
was last used be output* 

a a te_entr y_moci f led, -dtem 

reduests that the date on which the entry for a 
library link* segment* directory* archive* or 
multi-segment file was last modified* or the date 
on which a library archive component was last 
updated into its archive* be output* 



-date_dumped, -did 

requests that the date on which a I ibrary entry 
was last oumped onto a backup tape be output* 

- I engt h* - 1 n 

requests that the current length* records used- 
ana bit count or msf indicator of each library 
entry be output* The records used are included 
only when different from the current length* 

-current_J eng th» -cln 

requests that the current length of each library 
entry be output* 



-recoras_usedi -ru 

requests that the number of records occupied by 
each library entry be output* For a mu I ti-segment 
file, the value includes only those records used 
by the msf directory* Those occupied by the msf 
components are incluoec in the header information 
for each component* If both the current length 
and records used have been requested, then the 
records usee will be omitteo from the output if 
equal to the current length* 



-oit_count, -be 

requests that the bit count of each library 
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segment* archive* archive component* and msf 
component be output* a) ong with the msf Indicator 
of each library multi-segment file* 

-access* -acs 

requests that the user's access mode to each 
library entry* ano each library entry's ring 
brackets be output* 

-node* -md requests that the user's access mode to each 
library entry be output. 

-r ing^brackets* -rb 

requests that the ring brackets of each library 
entry be output* 

-contents* -c t 

requests that the contents of each library entry 
be checked to determine whether the entry is 
printable* The compiler version number and 
printable character length of each peruse text 
object entry is output* Other entries are merely 
checked for printabil ity* (See Jialas below*) 

-peruse^text * -pf 

requests that the compi I er version number and 
printable character length be output for each 
peruse text object entry* (See Notes below*) 

-device_id» -did 

requests that the type of device on which the 
library entry is stored be output* 



copy_switch* -cs 

requests that the copy switch 
library entry be output* 



setting for the 



offset requests that the offset (from the beginning of 
its containing segment) of the contents of an 
archive component be output* The offset is an 
octal word count* 



unique_id* -uid 

requests that the unique identifier of the library 
entry be output in octal* 
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-error, -er 

requests that any error which occurred while 
obtaining status be indicated by the appropriate 
error message* The message appears in the header 
information for the parent of the library entry in 
which the error occurred* 

- 1 eve I* - 1 v 

requests that a level number be output for each 
library entry. The level number indicates the 
relationship between a library entry and its 
components* For example* the header of the entry 
for an archive might have the archive at level 1 
and the archive's components at level 2. 
Normally* the level is indicated only by relative 
indentation of entry names* 

If the output file already exists* it is truncated and 
rewritten* Thus* if several I ibrary_print commands are executed 
in the same working directory (by the same process* or by 
different processes) without including an -output. file control 
argument* then the output of all but the last command is 
overwritten* In such cases* the -output.fi le control argument 
should be specified to prevent the output of the last command 
from overwriting the output of preceding commands* 

If the -header heading control argument is specified* then 
the heading character string is centered on the header page of 
the output file beneath the linesi 

Print Out of the qq Entries 

of the 

The tiaadioa character string shoulc be worded with this in mina. 
For examples 

Print Out of the 35 Entries 
of the 

Standard Service System Bind Listing Library 
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If no -header control argument is specified, then a default 
heading line is constructed by concatenating the library names* 
as shown below: 

Map of the 35o Entries 
of the 
Libraries 

s tan dard_ser vice • list , unbundl 3d. I is t, 
tools, list, author^ maintained* I ist, network. I ist 

If the -footer lafitiaa control argument is specified* then 
the IfioXiiig line appears at the lower left corner of each output 
page (except the header page), along with the name (s) of the 
level i entries appearing on that page, and the page number. If 
the -footer control argument is omitted, then the library names 
are concatenatea together as with the default heading line, and 
used as the default footing line. 

In order for some output arguments to take effect, 
information in addition to simple status must be available. 
Therefore, some output arguments automatically invoke certain of 
the control arguments. For example, the -contents output 
arguient requires that archive, character, and object checking be 
performeo, and therefore invokes the -check control argument. 
Similarly, the -peruse_text output argument invokes the 
-check_character control argument. The -all output argument 
invokes the -default and -check control arguments, as well as all 
of the output arguments. 

The default library name(s) and search name(s) used for the 
I i brar y_print command are defined in the library descriptor for 
the libraries being printed. The I ibrary__descr iptor command can 
be used to print these default values. In particular, the 
default values for the default library descriptor can be printed 
by typing the command: 

las defaults I ibrary_print 

Refer to the writeup on the 1 ibrar y_descriptor command for more 
Q8 tai I s. 
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When no -I i brary_descr iptor control argument is given in the 
command* the default library descriptor is used. The name of the 
default library descriptor can be set and printed with the 
I i brary_cescr ipt or commano* The initial default library 
descriptor describes the Multics System Libraries. 

The command 

I ibrary_pr i nt -lb info.* -lb peruse_text . inf o **.info **.pt 
-of documentation 

creates the documentat ion. print file in the working directory, 
which contains a print out of the entries in the info.* and 
peruse_text # * libraries which match the search names **.info or 
** • pt • The commana 

I Lbrary_pr i nt -lb onl ine. ob J ect **.bind -of online -dtd -dft 

creates the online. print file which contains a print out of all 
of the bind files, in the online object libraries. Each entry 
includes a header with the date dumped* as well as whatever 
aefault status information was specified by the library search 
program. The command 

I ibr ary_pr i nt 

creates a print out in the I ibrary. print file of the working 
directory which contains the contents of those entries in the 
default library (or libraries) which match the default search 
name(s). These default values are specified by the default 
library descriptor data base. 



I 1 

1 1 iorary_print 1 
I J 
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bLamfiS* I ibrary_descr iptor, Ids 

The I ibrary_descriptor command controls the use of library 
descriptors by library maintenance commands, and provides 
information about the contents of a library descriptor. The 
command! can print and set the name of the library descriptor 
which is used by default in library maintenance commands when no 
library descriptor is explicitly specified; can print the path 
names of the library roots which are associated with one or more 
library names? can print detailed information about one or more 
of the library roots defined by the descriptor; and it can print 
the default library and search names associated with each library 
command* 

The library descriptor is a data base which, with its 
associated library search program, defines the structure, 
contents, and naming conventions of the library. Refer to the 
writeup for the I ibrar y_descri ptor_compi I er for more information 
aoout library descriptors* 

I ibrary_descr iptor Key -options- 

The Keys and their options are described in the sections which 
foil ow. 

HSLiL s name 

The name key returns the name of the default library 
descriptor which is currently being used. I ibrar y_descr i ptor may 
be invoked as an active function when the name key is used. 

ii3.aa& 

I ibrary_descript or name 
&£^s set_name 

The set_name key sets the name of the default library 
desc~ i ptor. 



I I 
I I ibrar y_descri ptor I 
J I 
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I ibrary__cescr iptor set_name refname 

1) refname is the reference name of the new default library 

descriptor. The descriptor identified by refname 

is searched for according to the search rules* 
which are documented in MPM Section 3*2« 

path 

The path key returns the path name of the library root(s) 

which are identified by one or more library names. 
I i brar y_descr ipt or may be invoked as an active function when the 
path key is usee* 

Usaaa 

I ibrary_descr iptor path lib_namel ... lib_nameQ -c 1 1 _ar gl- 

1) lib_namei is a name which identifies the particular library 

or group of 1 ibraries whose paths are to be 
returned. The Multics star convention may be used 
to identify a group of libraries. 

2) ctl_argl may be the following optional control argument. 

-I ibrary_descriptor ref pafflft 
-I ds Qfilname. 

refname is the reference name of the library 
descriptor which defines the library roots whose 
path names are to be returned. The descriptor 
identified by Cfi.lD.aafi wiil be found by using the 
search rules* which are documented in MPM Section 
3.2. If the - I ibrary__descr iptor control argument 
is not specif ied t then the default library 
descriptor is usea. 

defaults 

The defaults key prints the default liorary name(s) and 
search name(s) associated with one or more of the library 
maintenance commands. 
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I ibrary_ciescr iptor 
- c 1 1 __argi~ 



defaults -commandi- 



-commanaQ- 



i) command^ 



is the name of the library maintenance command 
whose default library ana search names are to be 
printed. If no command names are given, the 
default for all of the library maintenance 
commands will be printed. 



2) ctl_argi 



may be any of the optional 
aefined for the path key. 



control arguments 



roots 



The roots key prints detailed information aoout one or more 
library roots on the user's terminal. The information includes 
the names on each library root* its path name* and its type. 



I ibrary__descriptor roots I ib_namei 
- c 1 1 _ar gQ- 



I ib_nameQ -ctl_argi* 



l) Jib_namei 



is a name which identifies the particular library 
roots about which information is to be printed. 
The Multics star convention may be used to 
iaentify a group of libraries. 



2) -ctl__argl may be one of the following control arguments. 



-name, -nm 



specifies that all of the names defined for the 
library root are to be printed. Usually* only the 
first name and names which match the lib_name± 
arguments are printed. 



- I ibrary_descri ptor r ef name 
-I ds cejuame. 

as above. 
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Ciama' mul tics_l ibrar ies__ 

This data base is the library descriptor for the Mul tics 
System Libraries. Like all library descriptors* it defines the 
roots of the Hultics System Libraries* the names by which library 
roots can be referencec in the various library maintenance 
commands* and the default library names and search names used for 
each of the library maintenance commands. 

Refer to the writeup on library descriptors for a definition 
of the internal structure of this (and other) library 
aescr* i ptors. Refer to the writeup on the 

I i bra r y__aescr i pt or_compi I er for the definition of the Library 
Description Language which is used to define the contents of the 
library descriptor. 

Ib£ 3uili£2 LJLbXsrJL&s. 

The Multics System is composed of the "logical libraries" 
listed below. Each of the libraries is* in turn* composed of 
several directories containing the different Kinds of library 
segments (source, object* bind lists* Info* include, peruse_text) 
which are storec in the libraries. A library maintenance command 
can reference an entire logical library by name* or one or more 
of its directories. 

Note that the logical library organization defined below 

does not map directly onto the physical library organization in 

the Hultics Storage System. However* the library maintenance 

tools can reference ail of the physical libraries through their 
logical library names. 

st anaaro_l ibrary * std 

the library which contains most user commands and 
subroutines* and the system support routines for these 
commands and subroutines. 

unbund led_J ibrar y* unb 

the library which contains Honeywell programmed products and 
other unbundled software. 

tools_library* tools 

the library which contains system maintenance and 
administrative commands ana subroutines. 
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insta Hat ion_l ibrary, inst 

the library which contains 

user. I ibrary , user 

the library which contains 

ne twork.l ibrary , net 

the library which contains 
Multics System to the ARPA 



instal lation-maintained software* 

user-maintained software. 

the software for linking the 
Ne twork • 



supervisor.! ibrary , sup 

the library which contains the supervisor (ring 0) segments 

of the Multics System- 
sal vager_l ibrary , salv 

the library which contains the Multics Storage System 

salvager commands and subroutines. 

boot I oad_l ibrary , bos 

the library which contains the commands and subroutines of 
the Bootload Operating System. 

data_net_355_l ibrary , 355 

the library which contains the commands ana subroutines of 
the Data Net 355 Operating System. 

Each of the above logical libraries contains one or more of the 
following logical directories. 

source, s 

the directory containing the source language segments which 
can be translated into the object segments of the library. 

object* o 

the directory containing the object segments produced by 
translating the source segments of the library. 

lists. I 

the directory containing the listings produced by binding 
several object segments together into a bound segment. 

execution, x 

the directory containing bouno and unbound object segments 
and data bases used by users of Multics. These directories 
are general ly included in the search rules of some or all 
users • 
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bounai_comp» be 

the directory containing the archives which may be bound 
into bound segments* 

info* i 

the directory containing information segments which can be 
printed on the user's terminal under control of the help 
commanc. These segments describe the commands and 
subroutines included in the library* and outline library 
problems* upcoming changes* etc. 

peruse_text» pt 

the directory containing the peruse^text object segments 
which describe the commands and subroutines of the library. 
Selected portions of these segments may be printed on the 
user's terminal under control of the peruse_text command. 

incl jae* inc I 

the directory containing source segments which are included 
as part of several other source segments* under the control 
of a language translator. 

Likcac* blades 

One or more libraries or directories may be referenced in a 
library maintenance command by giving the appropriate library or 
directory name. 

• An entire library can be referenced by giving one of the 
library names listed above. 

• A particular type of directory can be referenced across all 
libraries by giving one of the directory names listed above. 

• A particular directory within a specific library can be 
referenced by giving a 2-component name of the form* 
I ibrary* directory . For example* standard..! ibrary. source or 
instal lat ion_l ibrary. Inf o . 

• The star convention may be used to identify several 
libraries or directories. For example* *. source or • 

• Two groups of libraries car, be referenced by the following 
names? 

onl ine_l ibrar ies* on 

standard.! ibrary * unbuna I ea_l ibrary * tool s_l ibrary* 
insta I lation_l ibrary* user_l ibrary * network..! ibrary. 
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o f f I ine_l ibraries * off 

superv isor_l ibrary * sa I vager_J ibrary* boot I oad_J ibrary » 
oat a_net_355_J ibrary. 



Not all of the libraries listed above contain each type of 



directory. The following 
combinations are valid. 



lists show which I ibrary «di rector y 



std. source 

s to. obj ect 

s to. I ists 

std. execut i on 

s tc. inf o 

std* peruse_ text 

std. incl ude 



unb. source 
uno.ob J ect 
unb. I i sts 
unb.execut ion 
unb. inf o 
unb. peruse_text 
unb. include 



tools. source 
tool s. obj ect 
tools. I ists 
too I s. execut i on 
too I s. inf o 
too I s. peruse _t ex t 
too I s. inc I ude 



i nst .source 

i nst • ob] ec t 

inst • I ists 

i nst .execut ion 

inst . info 

i ns t • peruse _t ex t 

i nst . inc I ude 



user .source 
user. object 
user. I ists 
user . execut i on 
user. info 
user. peruse_ text 
user. inct ude 



net • source 
net .obj ect 
net • I i st s 
net . execut ion 
ne t • in f o 
ne t • peruse_tex t 
net • inc I ude 



sud. source 
sup. bouna_c omp 
sup. obj ect 
sup. inc I ude 



sal v. source 
sa I v.bouno_comp 
sal v.ob) ect 
sal v. incl ude 



bos. source 355. source 

bos. object 355. object 

bos • i ncl ude 



Some examples of library names ares 



on I ine_l ibr ar ies 
off .source 

standard_l ibrary. info 
i nc I ude 
u ser • x 

net work_ lib rary. lists 
pt 

stc. ?????? 
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The table below shows the default library names and search 
names used by each of the library maintenance commands. Commands 
which have no default values are not shown in the tao Je. 



I ibrary_map 
1 ibrary_pr int 



on I ine_l i brar ies 
info 



I ibrary_c leanup online_libraries 



**.inf o 
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